home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / others / html / mp_ste / english / mp_ste.eng < prev    next >
Text File  |  1997-07-15  |  17KB  |  486 lines
  1. ****************************************************************************
  2.             DOCUMENTATION OF MP_STE.PRG
  3. ****************************************************************************
  4.  
  5.  
  6.     Player of movies Quick Time (Mac), AVI (PC) images and sound,
  7.     FLI/FLC/FLH, GIF (PC), DL (?), SEQ, PI1+DLT, FLM/Extended FLM
  8.             and CDH/CDL (Atari).
  9.           Maker of MOV (images & sound!)
  10.           Maker of AVI (images & sound!)
  11.                       Maker of Animated-GIF
  12.               Maker of FLM (images & sound!)
  13.      Converter of AVI/MOV/FLI/FLC/FLH to Extended FLM with sound
  14.  
  15.  
  16. Author:
  17.  
  18. TELLO Guillaume
  19. 240 rue Estienvrin
  20. 49260 Montreuil Bellay
  21.     FRANCE
  22.  
  23. Email: gtello@wanadoo.fr
  24.  
  25. ******* Shareware **********
  26.  
  27.     You can register directly to me:
  28.  
  29.     CAN$15, US$10, 15DM, 60 French Francs (Eurocheques, bank notes
  30.     from your country, but not coins!).
  31.  
  32.     UK users, you can register (7UKP or more!) at:
  33.  
  34.         Antony Lacey   (algy@allatsea.demon.co.uk)
  35.     59 Owenford Road
  36.     Radford
  37.     Coventry CV6 3FQ
  38.     England
  39.  
  40.     North America Users, you can register (US$10 or CAN$15) at:
  41.  
  42.     Nima Montaser          Hardware and Software Specialists
  43.     Homa Systems House       ATARI Graphics and Multimedia
  44.        P.O. Box 52127          nima@magmacom.com
  45.        Ottawa, ON  K1N 5S0     aa414@freenet.carleton.ca
  46.        Canada   Tel:(613)722-0901   Fax:(613)722-9061
  47.                URL: http://www.magmacom.com/~nima
  48.  
  49.  
  50.     Limitations of the Shareware version:
  51.     SEE AT THE END OF THIS DOCUMENT.
  52.  
  53. ****************************
  54.  
  55.         OVERVIEW
  56.         ********
  57.  
  58. Capabilities:
  59. ¹¹¹¹¹¹¹¹¹¹¹¹¹
  60.     1) Allows you to create a MOV animation (Quick Time) from a serie
  61. of images listed into a BATCH file and with an optional sound:
  62.         - images TGA2 24 or 16 bits -> MOV with RLE16 compression
  63.         - images IMG ('ximg', 256 colors) -> MOV with RLE8
  64.         - sounds AVR, 8/16 bits, mono/stereo
  65.         - sounds WAV, 8/16 bits, mono/stereo
  66.     (see BATCH Files, SLIDSHOW.ENG)
  67.  
  68.     2) Allows you to create an AVI animation (Video for Windows) from
  69. a serie of images listed into a BATCH file and with an optional sound:
  70.         - images IMG ('ximg', 256 colors) -> MOV with RLE8
  71.         - sounds AVR, 8/16 bits, mono/stereo
  72.         - sounds WAV, 8/16 bits, mono/stereo
  73.     (see BATCH Files, SLIDSHOW.ENG)
  74.  
  75.     3) Allows you to create an animated GIF89a from a serie of GIF
  76. images only listed into a BATCH file:
  77.         - extension M_PLAYER for the number of frames
  78.         - extension DELAY for the timing infos
  79.         - extension NETSCAPE for looping
  80.     (see BATCH Files, SLIDSHOW.ENG)
  81.  
  82.     4) Allows you to create an Extended FLM animation from a serie of
  83. ST-Low images listed into a batch file and an optional sound:
  84.         - images DEGAS PI1 (320x200x16)
  85.         - images NEO (320x200x16)
  86.         - AVR/WAV sound (DMA frequencies +/-2% 8 bits mono/stereo)
  87.     (see BATCH Files, SLIDSHOW.ENG)
  88.  
  89.     5) Allows you to convert any supported MOV/AVI with sound or any
  90. FLI/FLC/FLH into a new FLM format with sound to get a high speed display:
  91.         - FLI/FLC/FLH converted to FLM with their original synchro
  92.         - MOV/AVI converted to FLM with their synchro + sound
  93.         - images are ST Low or ST High according to the current
  94.         monitor used.
  95.  
  96.     6) Can replay 12 types of animations:
  97.     - *.MOV (Quick Time)
  98.         - images compressions:
  99.              CVID (compressed yuv)
  100.              RLE1, RLE2 (grey and col), RLE4 (grey and col),
  101.              RLE8 (grey and col), RLE16, RLE24, RLE32
  102.              SMC8 (grey and col)
  103.              RAW1, RAW2 (grey and col), RAW4 (grey and col),
  104.              RAW8 (grey and col), RAW16, RAW24, RAW32
  105.              RPZA (15 bits)
  106.              WRLE (256 colors)
  107.              MSVC8 (grey and col), MSVC16
  108.              YUV2, YUV9, YVU9 (uncompressed yuv)
  109.         - sound mono/stereo, 8/16 bits, TWOS or RAW format
  110.         - synchronisation image/sound ON or OFF
  111.         - sound ON or OFF
  112.  
  113.     - *.AVI (Video for Windows)
  114.         - images compressions:
  115.              CVID
  116.              CRAM8, CRAM16
  117.              MSVC8, MSVC16
  118.              RLE8
  119.              RGB8
  120.              YUV9, YVU9
  121.              (no IV32, you must pay Intel $5000 to get the
  122.              licence. The less we use it, the best!)
  123.         - sound mono/stereo, 8/16 bits
  124.         - synchronisation image/sound ON or OFF
  125.         - sound ON or OFF
  126.  
  127.     - *.FLI/FLC/FLH (Autodesk Animator)
  128.     - *.SEQ     (Cyber Paint)        Not in monochrome
  129.     - *.PI1 + *.DLT    (Cyber)            Not in monochrome
  130.     - *.FLM        (Kinetic Microsystems)    Not in monochrome
  131.     - *.FLM        (Lexicor)
  132.     - *.DL        (types 1 and 2)
  133.         - images only
  134.         - speed ORIGINAL or MAXI
  135.         - loops (shift key)
  136.         (for PI1 + DLT, you must clic on the PI1 file, the DLT
  137.         file must be into the same folder with the same name, for
  138.         example: c:\ESSAI.PI1 and c:\ESSAI.DLT)
  139.  
  140.     - *.FLM (Extended FLM Lexicor)
  141.         - images 320x200x16, 640x480x16 or 640x400x2
  142.         - sound DMA 8 bits mono/stereo at 12017, 25033 or 50066 KHz
  143.         - independent timing for each frame
  144.  
  145.     - *.FLM        (Video Master V1.0)    Not in monochrome
  146.         - images 160x100x16 (VMAS)
  147.         - sound 8 bits, mono, any frequency
  148.  
  149.     - *.GIF    (Compuserve, 87a et 89a)
  150.         - synchro ON or OFF with delays (version GIF89a)
  151.         - the number of frames isn't displayed if the animation
  152.         doesn't contain the M_PLAYER extension.
  153.  
  154.     - *.CDH/*.CDL (CD Stratos)        Not in monochrome
  155.         - images mono (CDH) fitting into 640x400
  156.         - images 16 greys (CDL) fitting into 320x200
  157.         - DMA sound 8 bits mono 12516Hz
  158.  
  159.     - *.BAT (Batch Files for slideshow or movie creation):
  160.         - very simple language to display a serie of images (with
  161.         nested loops)
  162.         - supported formats:
  163.             TGA2 uncompressed (your POV creations!)
  164.             IMG ('XIMG' and 256 colors)
  165.             GIF (87a or 89a, 256 colors maxi)
  166.             PI1 (Degas 320x200x16)
  167.             NEO (Neochrome 320x200x16)
  168.         (see SLIDSHOW.ENG)
  169.  
  170.  
  171. Hardware required:
  172. ¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹
  173.  
  174.     Machine
  175.     ~~~~~~~
  176.  
  177.     - STF/Mega STF:    Yamaha PSG used for the sound...
  178.     - STE/Mega STE: DMA sound!
  179.     - TT without graphic card: DMA sound
  180.     - Falcon in ST Low or High: DMA sound
  181.     - PC + PaCifiST (GREAT ST Emulator)
  182.  
  183.     (For TT and Falcon, M_PLAYER.PRG is better than MP_STE.PRG because
  184. it is written for the 68030 and it can display up to 65536 colors).
  185.  
  186.     Supported sound systems:
  187.     - Yamaha PSG (every ST)
  188.     - DMA sound (TT, STE, Mega STE)
  189.     - Sound Cards:
  190.         * ST Replay 16
  191.         * ST Replay 8
  192.         * MV 16
  193.     (see at Ý 'Sound system selection')
  194.  
  195.     Display
  196.     ~~~~~~~
  197.  
  198.     MP_STE supports both color or monochrome display.
  199.  
  200.     --- Color Display ---
  201.     Every animation is displayed in ST Low mode using 16 grey levels if
  202. the animation has more than 16 colors (256, 32768, 65536, 16 millions) or
  203. 16 colors for the others (SEQ, FLM, DLT, MOV-RAW4,RLE4).
  204.     An optional mode is present to reduce the palette of the animations
  205. with 256 colors, then you'll get a COLOR DISPLAY! See at Ý 'Palette
  206. reduction' (option not available in the demo version).
  207.     The program switches automatically to ST Low, thus it can be run
  208. in ST Medium on a ST(E) or in any resolution on a TT.
  209.  
  210.     --- Monochrome Display ---
  211.     Every animation with at least 256 colors is displayed en ST High
  212. using a fast dithering. Those with less than 256 colors, except FLM in ST
  213. High, are not currently supported.
  214.  
  215.         Memory
  216.         ~~~~~~
  217.  
  218.     A ST(E) with 1Mb can be enough for many little animations, but you
  219. should know that, when there is a sound, it is loaded entierely before the
  220. animation is displayed (faster then, cause only the images are treated
  221. while playing). So, with those kind of animations 2Mb or 4Mb seem to be
  222. better.
  223.  
  224.     Drives
  225.     ~~~~~~
  226.  
  227.     Floppies can be enough, but once again, the images are loaded one
  228. by one (to save memory) while playing, and so, using floppies will slow
  229. down the animation. A Hard drive is highly recommended (Or use a
  230. RAMDISK...).
  231.  
  232.  
  233.             RUNNING THE PROGRAM
  234.             *******************
  235.  
  236. The files
  237. ¹¹¹¹¹¹¹¹¹
  238.     MP_STE.PRG/ACC    ; the program
  239.     MP_STE.RSC    ; its interface (into the same folder!)
  240.     MP_STE.ENG    ; you're reading me
  241.     HISTORIC.TXT    ; programmer's daily
  242.     SLIDSHOW.ENG    ; doc for BATCH files, MOV-Maker, GIF-Maker
  243.     COMMANDS.ENG    ; options of the command line (en mode TTP)
  244.     FORMATS.ENG    ; my extensions for FLM, GIF and ACC message
  245.  
  246. Running
  247. ¹¹¹¹¹¹¹
  248.  
  249.     How to select the animation
  250.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  251.  
  252.     MP_STE can be lauched as a PRG but also as an accessory, you just
  253. have to rename it as MP_STE.ACC and copy it (with its RSC) into the
  254. root directory of the boot drive.
  255.     It can also be run as a TTP or GTP with a command line containing
  256. options (see COMMANDS.ENG).
  257.  
  258.     The file name can contain '*' and '?' (wildcards) to replay
  259. several animations from the same directory.
  260.  
  261.     Infos into the first dialog box
  262.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  263.  
  264.     It indicates the filename, the size of the animation (or 'No
  265. graphics found') and the number of frames included (most of the GIFs
  266. haven't this information stored if they have not the M_PLAYER extension).
  267.     It gives the sound parameters (or 'No sound').
  268.  
  269.     Graphics and sounds can be 'Supported' (known by MP_STE) or
  270. 'Unsupported' (unknown, so they won't be replayed). This is also
  271. indicated.
  272.  
  273.     Settings into this box
  274.     ~~~~~~~~~~~~~~~~~~~~~~
  275.  
  276.     For AVI/MOV/GIF/Extended FLM you get:
  277.     [] Play Sound
  278.     [] Synchronise
  279.  
  280.     that allow you to replay the sound or not and to synchronise the
  281. images with the timings included into the file.
  282.     On slower machines, synchronisation leads to skip some frames to
  283. 'follow' the original timings. With 8Mhz, it is sometimes better to set
  284. OFF the synchronisation (longer display, but not jerky). This is no longer
  285. true with the Extended FLM whose format is adaptated to the Atari display,
  286. so you get a very good quality of animation.
  287.  
  288.     For the other animations you get two radio-buttons:
  289.     [] max speed
  290.     [] xxx frames/sec
  291.  
  292.     Max speed allows you to replay every frame without timing
  293. consideration, the other button allows you to limit the speed to its
  294. original value (the one contained into the file). If the machine is slow,
  295. both options lead to the same display.
  296.  
  297.     Replay the animation
  298.     ~~~~~~~~~~~~~~~~~~~~
  299.  
  300.     With the 'Go!' button, you start the animation with the settings
  301. you specified.
  302.     If the button is named '(Alt) Go!', it means that a second option
  303. is available if you press 'Alt' while clicking:
  304.     BATCH Files:
  305.     - instead of a slideshow, you create a MOV, AVI, FLM or a GIF file.
  306.     MOV/AVI/FLI/FLC/FLH files:
  307.     - instead of the animation, you get a conversion of your file into
  308.     the Extended FLM format ('Play sound' adds or not the sound into
  309.     the FLM, 'Synchronise' or 'xxx frames/sec' copies the original
  310.     timing infos into the FLM).
  311.  
  312.     End of the animation
  313.     ~~~~~~~~~~~~~~~~~~~~
  314.  
  315.     AVI/MOV: Control stops the animation, else ends at the end...
  316.  
  317.     GIF: Control stops the animation, Shift stops a looping file at
  318.     the end of the current loop, Shift loops on a non-looping file
  319.  
  320.     Others: Control stops the animation, Shift makes it loop
  321.  
  322.     Infos in the second dialog box
  323.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  324.  
  325.     These are some statistics:
  326.     * Total frames:    number of frames into the file
  327.     * Frames displayed: number of frames actually displayed (100%
  328.     without synchro, 100 or less with synchro if frames have been
  329.     skipped)
  330.     * Total time: number of seconds that the animation lasted
  331.     * Average: number of frames per second
  332.  
  333.     Sound System selection
  334.     ~~~~~~~~~~~~~~~~~~~~~~
  335.  
  336.     To go to the sound systems list, you must 'Shift'+Clic on the
  337. 'Info... / ^ Sound' button or 'Shift'+Clic on the Information dialog
  338. itself.
  339.     Then, you clic on the sound system you've got!
  340.     If one of them appears not to be present (DMA according to the
  341. cookie for example) it will be displayed in grey, and so, disabled.
  342.  
  343.     If you want your sound system being the default one, clic on
  344. 'Save and Exit', this will update the RSC file for you.
  345.  
  346.     The best sound system is the DMA (0% of machine time!), then there
  347. are the sound cards (26% with ST Replay 16 and a STE 8MHz), then comes the
  348. Yamaha PSG (36% of machine time).
  349.  
  350.  
  351. How was it programmed?
  352. ¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹
  353.     It has been entierely programmed in ASM 68000 using ASSEMBLE
  354. (Brainstorm). This program is an adaptation of M_PLAYER that is a 68030
  355. version for TT and Falcon (256c to True Color).
  356.  
  357. Limits of MP_STE
  358. ¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹
  359.  
  360.     The frequencies of the sounds
  361.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  362.  
  363.     The files from the MAC or PC have often frequencies close to
  364. 11025Hz, 22050Hz et 44100Hz (I accept +/- 2%). The DMA on the Atari knows
  365. 12517Hz, 25033Hz et 50066Hz. Each time I load a sound I convert it from PC
  366. frequencies to DMA frequencies (each 8th sample, I add a 9th value, and
  367. the correspondance 8 to 9 gives a very fast and good conversion).
  368.     If there is no DMA system, the sound is always played at 9600Hz
  369. using hardware interruptions (Timer A) using the correspondance 8 to 7) and
  370. always in mono.
  371.     If the sound is not played (also it was 'Supported'), it means that
  372. you haven't enough memory. Try to select the Yamaha PSG instead of the
  373. DMA sound, because:
  374.     DMA: 1 second 8 bits stereo 25033Hz = 50066 bytes
  375.     PSG: 1 second 8 bits mono at 9600Hz =  9600 bytes!
  376.  
  377.     Size of the images with a color display
  378.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  379.  
  380.     The screen mode is ST Low (320x200):
  381.     - every animation below 320x200 is displayed as is.
  382.     - if the width is greater than 320, it is reduced to its half (in
  383.     both directions for proportions)
  384.     - if the height is greater than 200, only the central part can be
  385.     seen
  386.  
  387.     Examples:
  388.         320x240    -> only lines from 20 to 219 are displayed
  389.         640x400 -> reduced to 320x200
  390.         640x480 -> reduced to 320x240 and only lines from 20 to
  391.         219 are displayed
  392.  
  393.     Finally, every animation up to 640x??? is accepted.
  394.  
  395.     Size of the images with a Monochrome Display
  396.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  397.  
  398.     The screen mode is ST High (640x400):
  399.     - every animation below 640x400 is displayed as is.
  400.     - if the height is greater than 400, the central part is displayed
  401.  
  402.     Particular cases:
  403.     * DL animations are always doubled on the screen
  404.     * when converting an anim to FLM, if its size is below 320x200, it
  405.     is doubled.
  406.  
  407.  
  408.     Palette reduction (not in monochrome)
  409.     ~~~~~~~~~~~~~~~~~
  410.  
  411.     There are only 16 colors available on a ST(E). So, if the the
  412. animation has 16 colors, you'll get them, if more you'll get 16 grey
  413. levels. But, if the animation has 256 colors, you can try to reduce the
  414. palette to get a color display (when this option is available, you get
  415. an up arrow displayed into the 'Go!' button).
  416.     To do this, you must use the Shift key while clicking on the 'Go!'
  417. button, the analysis begins: all the frames are read and the number of
  418. colors actually used is displayed.
  419.     Those informations are saved and will remain available as long as
  420. you don't run another analysis.
  421.     Then, you must run again the animation with Shift + 'Go!' and,
  422. after a short delay (computing the new palette), you get your COLOR
  423. animation!
  424.  
  425.     You can combine, at the second 'Go!', the effects of Shift and Alt
  426. to save a FLM file with colors!
  427.  
  428.     Accepted formats for palette reduction are:
  429.     MOV: RAW8, RLE8, MSVC8, WRLE, SMC
  430.     AVI: RLE8, RGB8, CRAM8, MSVC8
  431.     FLI, FLC
  432.         DL
  433.  
  434. Limitations of the Shareware version
  435. ¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹¹
  436.  
  437.     MOV, AVI and GIF maker
  438.     ~~~~~~~~~~~~~~~~~~~~~~
  439.  
  440.     The animations created with MP_STE will contain a grey palette
  441. when using the unregistered version. This is not really a limit if you use
  442. those animations on the ST, because anyway, they are displayed in grey.
  443.     But if you want to export your work on another machine with a
  444. higher display (Falcon, TT, PC, MAC), only the registered version will
  445. allow you to get colored animations.
  446.  
  447.     FLM Maker
  448.     ~~~~~~~~~
  449.  
  450.     When you create a FLM from a serie of Degas/NEO images, you get a
  451. grey palette with the unregistered version.
  452.  
  453.     Extended FLM with sound/AVI/MOV/FLI conversions
  454.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  455.  
  456.     MP_STE defines a new FLM format with timing infos and sound to get
  457. high speed animations on a ST(E), the FLM format is ST Low or ST High
  458. according to the current display.
  459.     You can convert any supported MOV/AVI/FLI/FLC/FLH to FLM keeping
  460. its synchro and sound. If you are using the unregistered version, you
  461. won't be able to save the sound into the FLM (only the images with the
  462. synchro).
  463.  
  464.     Palette reduction
  465.     ~~~~~~~~~~~~~~~~~
  466.  
  467.     In the demo version, you can't get colors with the 256 colors
  468. animations, you must register to get this option.
  469.  
  470.     Where to find the last version?
  471.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  472.  
  473.     On the WEB:
  474.     http://perso.wanadoo.fr/gtello ('official' page)
  475.     http://www.tripnet.se/~mille
  476.     http://www.magmacom.com/~nima
  477.     http://www.allatsea.demon.co.uk
  478.  
  479.     FTP site:
  480.     ftp://193.190.205.13/Archive/atari
  481.  
  482.     BBS:
  483.     'The BBS' in Paris-France (01 42 51 11 35)
  484.  
  485.     Names are MPSTExxx.ZIP (STE, xxx is the version number) and
  486. MPLYRxxx.ZIP (TT/Falcon).